RESOURCE ADAPTER AND INTEGRATED DEVELOPMENT ENVIRONMENT 

BACKGROUND OF THE INVENTION 

Field of the Invention 

The present invention relates to application development and operation and, more 
5 particularly, to resource adapters and the development of applications using an integrated 
development environment. 

Description of the Related Art 

As a result of the widespread use and development of electronic commerce (e-commerce, 
whereby transactions for a variety of goods and services are conducted electronically) and 

10 electronic business (e-business, whereby business processes , e.g., shipping, procvirement, 

staffing, etc, are transformed so as to be conducted electronically), applications have been, and 
continue to be, developed to interact with numerous back end systems to access and store 
inforaiation related to an e-business or e-commerce transaction. For example, an e-business 
application, designed to provide for web based purchasing of goods or services, may need to 

15 interact with numerous back end systems to ensure that a good or service purchased is delivered 
on time to the customer making the purchase. Such a transaction, while apparently simple, may 
involve numerous back end systems (sometimes referred to as Enterprise Information Systems 
(EISs) related to: parts procurement, receiving, manufacturing or Enterprise Resource Planning 
(ERP) systems, shipping, accounting and many others. Additionally, many of these EISs, often 

20 the result of many years of development and storing vast amounts of data, were often not created 
to interact easily with other systems (i.e., these legacy EISs were often stand alone systems). As a 
result of this complexity, the development of a single business application which interacts with 
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one or more EISs to provide for one or more e-business services is the effort of much research 
and development. 

To address the complexity in developing a business application, resource adapters have 
been developed which ease the difficulty for interaction between a business application and an 

5 EIS. The resource adapter (also sometimes referred to as a "connector") acts as an intermediary 
or broker between an EIS and a business application. A resource adapter architecture generally 
defines a standard set of services that allow developers to quickly connect and integrate their 
business appUcations with virtually any back end enterprise information system. Resource 
adapters typically are supplied by the developer of the EIS. A resource adapter (or connector) 

10 appears as a component (or library) specific to an EIS that provides connectivity to the EIS. It is 
possible to conceptualize the resource adapter's fixnction as analogous to a Java™ Database 
Connector (JDBC) driver, which is a programming interface that lets Java applications access 
data in a relational database. Java is a trademark of Sun Microsystems, Inc. 

Without the use of resource adapters, business application developers often do not fully 
15 appreciate the complexities involved in leveraging established enterprise applications and end up 
spending too much time understanding and coding to each particular EIS's integration APIs (if 
APIs are even available). Then, the hand-coded logic they develop often provides narrow 
opportunities for reuse, because it is application-specific by design. 

However, resource adapters are not without their own problems. Firstly, each resource 
20 adapter is typically specific to a single EIS. As such, for "n" number of EISs, "n" resource 
adapters need to be created. This is often not too problematic in isolation. However, the 
ElS-specific nature of a resource adapter is coupled with the fact that the resource adapters, 
which are used at runtime (i.e., during execution of a business application), require adapter tools 
to be created (typically by the manufacturer or provider of the resource adapter) that are used by 
25 an Integrated Development Environment (IDE) to create a business application that can utilize 
the corresponding resource adapter. As such, a resource adapter is not only specific to the EIS 
with which it is designed to interact, but the tooling which corresponds to the resource adapter is 
also specific to an IDE. As a result, if tooling is to be created for "m" number of IDEs, "m" 
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adapter tools will also need to be created. Therefore, for a provider of resource adapter-tool sets 
to provide resource adapter-tool sets for "n" number of EISs and "m" number of IDEs will 
require the creation of "m" x "n" resource adapter-tool sets to be created. This is an extremely 
time consuming and costly undertaking. As such, developers of business applications are 
5 typically limited to using an adapter-tool set from the EIS supplier and, possibly, using an IDE 
that the developer typically does not use as their normal or preferred IDE is not supported by the 
adapter-tool set. 

As such, a resource adapter tooling architecture which addresses some or all of these 
shortcomings is desired. 

1 0 SUMMARY OF THE INVENTION 

The present invention is directed to resource adapters and an integrated development 
environment. 

In one aspect of the present invention a resource and tooling adapter (RTA), a new kind 
of resource adapter, interacts, in the development process, with an integrated development 
15 environment (IDE). The RTA, responsive to a request from the IDE, provides identification of 
the services provided by the EIS. Additionally, the RTA provides data to the IDE describing how 
to access or invoke those services. Utilizing the data (describing the services and how to use 
those services of an EIS) an IDE is able to generate a business application designed to exploit the 
services of the EIS. 

20 In a fiirther aspect of the present invention, the RTA (previously employed by an IDE to 

develop a business application) also provides runtime support to enable commimication between 
the business application and the selected EIS. 

Advantageously, providers of resource adapter-tool sets need only develop a single RTA 
which can be used during both the development process and during runtime of the developed 
25 business application. 
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In a further advantage, all IDEs, developed or modified to interact with RTAs embodying 
aspects of the present invention, will be enabled to create business applications for every EIS for 
which a RTA, embodying aspects of the present invention, has been developed. 

In a still further advantage, developers, comfortable or preferring a particular IDE, will 
5 not be forced to switch to a different IDE as they may have been forced to previously. As noted 
above, a switch to a different IDE may be forced when a resource adapter-tool set did not exist 
for a developer's preferred IDE when a business application which accesses a selected EIS 
needed to be developed. 

Other advantages of the present invention will be apparent to those of ordinary skill in the 
10 art upon reading and understanding of the entirety of the present application. 

In accordance with an aspect of the present invention there is provided a resource adapter 
comprising: a first mechanism providing a description of a service provided by an enterprise 
information system sufficient to invoke said service; a second mechanism for invoking said 
service described; said resource adapter adapted to communicate with an integrated development 
15 environment to assist in development of a business application; and said resource adapter further 

adapted to communicate with a business application during execution of said business 
application. 

In accordance with still another aspect of the present invention there is provided a method 
for generating code for a business application, said code adapted to use a connector to access a 
20 service provided by an Enterprise Information System (EIS), said method comprising: receiving 
data describing said service provided by said EIS; mapping said data describing said service to 
elements of said connector; generating code of said business application, said code implementing 
said mapping. 

In accordance with another aspect of the present invention there is provided an integrated 
25 development environment (IDE) for generating a business application, said business application, 
when executed, uses services provided by an enterprise information system (EIS), said IDE 
comprising: an interface for querying a resoxirce and tooling adapter to ascertain a service 
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provided by said EIS; said interface for receiving a response to a query from a resource and 
tooling adapter, said response describing said service provided by said EIS and information to 
invoke said service; and a generator generating code for said business application to access said 
service, said code using data from said response. 

5 

In accordance with another aspect of the present invention there is provided a computer 
readable media storing data and instructions readable by a computer system, said computer 
system executing an integrated development environment (IDE) for generating a business 
application to access a service provided by an Enterprise Information System (EIS), said data and 
10 instructions defining a resource and tooling adapter that, when deployed on said computer 
system, adapts said IDE to: obtain a description of said service, said description providing details 
required to invoke said service; and using said description of said service, generate code which 
when executed, communicates with said resource and tooling adapter to use said service. 

In accordance with another aspect of the present invention there is provided a resource 
1 5 adapter comprising: first means for communicating with an integrated development environment 
(IDE) during development of a business application; second means for communicating with an 
Enterprise Information System (EIS); third means for communication with an executing business 
application; fourth means for providing a description of a service provided by said EIS to said 
IDE; and fifth means for mapping aspects of said description of said service to said third means. 

20 In accordance with another aspect of the present invention there is provided a method of 

adapting an integrated development environment to enable generation of code to use a service 
provided by a back end system, said method comprising: transmitting to said integrated 
development environment data describing said service; and mapping elements of said data 
describing said service to elements of a connector, said connector for facilitating commxmication 

25 between said back end system and an application generated to use said service provided by said 
back end system. 
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In accordance with another aspect of the present invention there is provided a resource 
adapter comprising: a connector adapted to faciUtate, during execution of an application, 
communication between said application and a back end system resulting in said application 
using a service provided by said back end system; functions to provide an integrated 
5 development environment with a description of said service wherein said elements of said 
description map to elements of said connector. 

Other aspects and features of the present invention will become apparent to those 
ordinarily skilled in the art upon review of the following description of specific embodiments of 
the invention in conjunction with the accompanying figures. 

1 0 BRIEF DESCRIPTION OF THE DRAWINGS 

In the figures which illustrate an example embodiment of this invention: 

FIG. 1 schematically illustrates a computer system embodying aspects of the invention; 

15 FIG. 2 schematically illustrates, in greater detail, a portion of the computer system of FIG. 

1; 

FIG. 3 illustrates, in functional block form, a portion of the memory illustrated in FIG. 2; 

20 FIG. 4 is a illustrates a first interaction of some of the components of FIG. 2 during the 

development of a plurality of business applications; 

FIG. 5 is a illustrates a second interaction of some of the components of FIG. 2 during the 
operation of business applications developed employing aspects of the present invention; 

25 

FIG. 6 illustrates, in greater detail and in functional block form, a portion of FIG. 3; 
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FIG. 6a illustrates, in greater detail and in functional block form, a portion of FIG. 6; 



FIG. 7 illustrates a flow chart of operations performed during the development of a 
business application illustrated in FIG. 4; and 

5 

FIG. 8 illustrates a flow chart of operations performed during the execution a business 
application. 
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DESCRIPTION OF THE PREFERRED EMBODIMENT 

An embodiment of the invention, computer system 100, is illustrated in FIG.L Computer 
system 100, illustrated for exemplary purposes as a networked computing device, is in 
communication with other networked computing devices (not shown) via network 110. As will 
5 be appreciated by those of ordinary skill in the art, network 110 may be embodied using 
conventional networking technologies and may include one or more of the following: local area 
networks, wide area networks, intranets, public Intemet and the like. 

Throughout the description herein, an embodiment of the invention is illustrated with 
10 aspects of the invention embodied solely on computer system 100. As will be appreciated by 
those of ordinary skill in the art, aspects of the invention may be distributed amongst one or more 
networked computing devices which interact with computer system 100 via one or more data 
networks such as, for example, network 1 10. However, for ease of understanding, aspects of the 
invention have been embodied in a single computing device (computer system 100). 

15 

Computer system 100 includes processing system 102 which conmiunicates with various 
input devices 104, output devices 106 and network 110. Input devices 104, two of which are 
shown, may include, for example, a keyboard, a mouse, a scanner, an imaging system (e.g., a 
camera, etc.) or the like. Similarly, output devices 106 (only one of which is illustrated) may 
20 include displays, information display unit printers and the like. Additionally, combination 
input/output (I/O) devices may also be in conmiunication with processing system 102. Examples 
of conventional I/O devices include removable and fixed recordable media (e.g., floppy disk 
drives, tape drives, CD-ROM drives, DVD-RW drives, etc.), touch screen displays and the like. 

25 Exemplary processing system 102 is illxistrated in greater detail in FIG. 2. As illustrated, 

processing system 102 includes several components, including central processing unit (CPU) 
202, memory 204, network interface (I/F) 208 and I/O I/F 210, Each component is in 
communication with the other components via a suitable communications bus 206 as required. 
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CPU 202 is a processing unit, such as an Intel Pentium™^ IBM PowerPC™, Sun 
Microsystems UltraSparc™ processor or the Hke, suitable for the operations described herein. As 
will be appreciated by those of ordinary skill in the art, other embodiments of processing system 
5 102 could use alternative CPUs and may include embodiments in which one or more CPUs are 
employed. CPU 202 may include various support circuits to enable conraiunication between 
itself and the other components of processing system 102. 

Memory 204 includes both volatile and persistent memory for the storage of: operational 
10 instructions for execution by CPU 202, data registers, application storage and the like. Memory 
204 preferably includes a combination of random access memory (RAM), read only memory 
(ROM) and persistent memory such as that provided by a hard disk drive. 

Network I/F 208 enables communication between computer system 100 and other 
15 network computing devices (not shown) via network 110. Network I/F 208 may be embodied in 
one or more conventional conmiunication devices. Examples of a conventional conmiunication 
device include an Ethemet card, a token ring card, a modem or the like. Network I/F 208 may 
also enable the retrieval or transmission of instructions for execution by CPU 202 from or to a 
remote storage media or device via network 110. 

20 

I/O I/F 210 enables communication between processing system 102 and the various I/O 
devices 104, 106. I/O I/F 210 may include, for example, a video card for interfacing with an 
external display such as output device 106. Additionally, I/O I/F 210 may enable communication 
between processing system 102 and a removable media 212. Although removable media 212 is 
25 illustrated as a conventional diskette other removable memory devices such as Zip"^^ drives, flash 
cards, CD-ROMs, static memory devices and the like may also be employed. Removable media 
212 may be used to provide instructions for execution by CPU 202 or as a removable data 
storage device. Zip is a trademark of Iomega Corporation. 
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The computer instructions/applications stored in memory 204 and executed by CPU 202 
(thus adapting the operation of computer system 100 as described herein) are illustrated in 
functional block form in FIG. 3. As will be appreciated by those of ordinary skill in the art, the 
delineation between aspects of the applications illustrated as functional blocks in FIG. 3 is 
5 somewhat arbitrary as the various operations attributed to a particular application as described 
herein may, in alternative embodiments, be subsumed by another application. 

As illustrated, for exemplary purposes only, memory 204 stores operating system (OS) 
302, conmiunications suite 304, IDE 306, resource adapters 308a, 308b, 308i, business 
10 applications 310a, 310b, 310i, EISs 312a, 312b, 312i and application server 314. 

OS 302 is an operating system suitable for operation with a selected CPU 202 and the 
operations described herein. Multitasking, multithreaded OSes such as, for example, IBM 
AIX™, Microsoft Windows NT^^, Linux or the like, are expected in many embodiments to be 
15 preferred. 

Conmiunication suite 304 provides, through, interaction with OS 302 and network VF 
208 (FIG. 2), suitable communication protocols to enable communication with other networked 
computing devices via network 110 (FIG. 1). Communication suite 304 may include one or more 
20 of such protocols such as TCP/IP, ethemet, token ring and the like. 

Also stored in memory 204 (and used during the development process) and incorporating 
aspects of the present invention is Integrated Development Environment (IDE) 306. In the 
exemplary embodiment, IDE 306 provides a developer (or a team of developers) a development 

25 environment using a graphical user interface (GUI) known to those skilled in the art. The GUI 
typically includes a number of windows or panes for viewing source code, project files, 
debugging information or the like. Unlike conventional IDEs, DDE 306 is adapted to have one or 
more resource tooling adapters (RTAs) 308 (described in detail below) "plugged in". That is, IDE 
306 is adapted to conmiunicate with one or more RTAS 308 serially or simultaneously. Through 

30 conmiunication with RTAS 308, IDE 306 is able to assist developers in developing a business 
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application 310 which is designed to use the services provided by one or more selected EISs 312. 
The operation of IDE 306 and its interaction with a RTA 308 and a business application 310 is 
better understood with reference to FIGS. 4 and 7 described below. 

5 RTAs 308a, 308b, 308i (collectively RTAS 308), during the development process of a 

business application 310, communicate with, or plug into, IDE 306. Each RTA 308 corresponds 
to a selected EIS 312. That is, each RTA 308 in the exemplary embodiment is specific to a 
particular EIS 312. The RTAs (resource and tooling adapters) embody a new type of resource 
adapter that may be employed during both development of a business application and runtime 
10 (i.e., execution) of the business application. 

It should be noted that, in altemative embodiments, a single RTA 308 could be employed 
to communicate (either serially or simultaneously) with more than one EIS 312. This may be 
particularly advantageous if there exists a high degree of similarity between the more than one 
15 EISs 312. 

The RTAs in the exemplary embodiment are adapted firom the Java 2, Enterprise Edition 
(J2EE) Connector Architecture. The J2EE Connector architecture, some aspects of which are 
described below, is described in greater detail in the document entitled "J2EE Connector 
20 Architecture Specification", JSR 016, Version 1.0, Final Release, Released August 22, 2001 
firom Sun Microsystems, Inc. of Palo Alto, California, the contents of which are hereby 
incorporated herein by reference. 

Through communication with IDE 306, a RTA 308 will, responsive to a request, provide 
25 data describing the services which are available from an EIS 312 (e.g., database facilities, 

transaction facilities, security authorization services, etc.). In addition to communicated services, 
a RTA 308 provides data to IDE 306 which details how to invoke a service (e.g., the parameters 
to use, the location of a service and the like). In the exemplary embodiment, the operations and 
fimctionality of a J2EE connector is extended by a Web Services Description Language (WSDL) 
30 document. The J2EE Connector Architecture provides a standard cUent programming model for 
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accessing EIS services. However, as will be appreciated by those of ordinary skill in the art, other 
connector architectures, such as the Common Connector Framework (CCF) from International 
Business Machines Corporation, which are designed to be used by applications during runtime to 
communicate with back end system could equally be employed. 

5 

The WSDL elements include two aspects (described in greater detail below with 
reference to FIG. 6): the first aspect provides an abstract service interface definition; the second 
aspect provides data on how to interact with a service specified by the first aspect and the 
location of a service. The second aspect which forms part of a RTA 308 is described in greater 
10 detail below with reference to FIG. 6 and is hereinafter referred to as the "extensibihty elements". 

WSDL provides a standard way for describing which services are offered by a specific EIS 
instance, and how you access them. WSDL, in XML format, describes network services as a set of 

15 endpoints operating on messages containing either document-oriented or procedure-oriented 
information. The operations and messages are described abstractly and then bound to a concrete 
network protocol and message format to define an endpoint. Related concrete endpoints are 
combined into abstract endpoints (services). WSDL is extensible to allow description of 
endpoints and their messages regardless of what message formats or network protocols are used 

20 to communicate. WSDL can be better understood with reference to the World Wide Web 
Consortixmi (W3C) document entitied "Web Services Description Language (WSDL) 1.1" dated 
March 15, 2001 the contents of which are hereby incorporated herein by reference. While the 
exemplary embodiment described herein utilizes WSDL, other languages which describe services 
could also be employed. As will be appreciated by those of ordinary skill in the art, other 

25 languages to describe the services of an EIS and how to invoke those services could equally be 
employed. For example, it is contemplated that the Electronic Business XML (ebXML) language 
promulgated, in part, by the United Nations Centre for Trade Facilitation and Electronic Business 
(UN/CEFACT) could, altematively, be employed. 
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A document fiom the Sun Microsystems, Inc. (Java Community Process group) of Palo Alto, 
California entitled JSR 110 "Java APIs for WSDL" describes a proposed standard set of APIs for 
representing and manipulating services described by WSDL documents. These APIs define a way to 
construct and manipulate models of service descriptions. The contents of "Java APIs for WSDL" is 
5 hereby incorporated herein by refCT^ce. 

RTAs 308 also communicate with business ^plications 310 (during runtime), EISs 3 1 2 (during 
runtime and, in an one embodiment - the exemplary embodiment - of the present invention, also during 
the development process) and application server 314. The communication betwem RTAS 308 and the 
1 0 other components of computer system 1 00 (illustrated as forming part of memory 204 in FIG. 3) is best 
understood with reference to FIGS. 4-8, described below. 

EISs 312 (which include individual EIS 312a, 312b, ... 312i) are conventional enterprise 
information systems. These may include, for example, databases for human resource data, 
15 inventory data and the like, ERPs, transaction servers, etc. Any type of EIS 312 which may be 
used to facilitate an e-commerce or e-business transaction maybe employed. 

A business application 310 (a plurality of business applications, 310a, 310b, 31 Oi are 
illustrated in FIG. 3), which may or may not have been developed by IDE 306, employs or uses 
20 the services of one or more EISs 312 through communication with RTAS 308 during runtime. 
An IDE is used to develop a business application 310 to use and employ the services of an EIS 
3 12. In the exemplary embodiment the information required by the IDE to use the services for an 
EIS 312 is obtained fi-om data describing the services available and how to invoke or use tiiese 
services fi-om a RTA 308. 

25 Application server 314 is a conventional application server that hosts or coimects to, 

during runtime, one or more RTAS 308. An application server 314 assists in the conmiunication 
between an EIS 312 and a business application 310 (through RTA 308) that is attempting to 
utilize the services provided by the EIS 312. 



CA9-2001-0078 



With reference to FIG. 4, the interaction of some of the components shown in FIG.3 is 
schematically illustrated. As indicated by FIG. 4, each RTA 308 is associated with a selected EIS 
312. In FIG. 4, business application 310a is being developed (through the development facilities 
of IDE 306) that requires use of the services of two EISs: EIS 312a and EIS 312b. To generate 
5 the source code necessary to access the services of EISs 312a5 312b5 two corresponding RTAs 
308a, 308b are plugged into IDE 306. By plugging RTAs, IDE 306 is provided data describing 
the services available from the EIS 312 associated with a particular RTA 308 (i.e., IDE 306 will 
be provided data describing the services of EIS 312a by associated RTA 308a; RTA 308b will 
similarly provide data describing the services of EIS 312b to IDE 306). Through this information 

10 received from RTAs 308a, 308b, IDE 306 is able to assist in the generation of business 
appUcation 310a which, during runtime, will use the services of EISs 312a, 312b. It is to be noted 
that while business application 310a is shown as being in communication with RTAs 308a and 
308b (illustrated by way of a dashed arrow), in the exemplary embodiment there is no direct 
communication between a business application 310 under development and a RTA. Rather, the 

15 dashed arrows are used to illustrate that there is indirect communication between a business 
application 310 under development and one or more RTAS 308 (this indirect commxmication 
provided through the conmiunication between IDE 306 and RTAS 308). In fact, only during 
runtime is a business application 310 aware of the existence of a RTA 308. 

During development and in the exemplary embodiment, a RTA 308 has two fiinctions 
20 included in a WSDL document (described briefly above, in greater detail below) which are 
invoked by IDE 306. The two fiinctions are invoked to ascertain the services provided by an 
associated or corresponding EIS 312 and how to use or invoke these services. This document is, 
in the exemplary embodiment, the only source of information for obtaining data describing the 
services of an EIS 312 during the development of a business application 310. The WSDL 
25 document which forms part of each RTA 308 in the exemplary embodiment, is created prior to a 
RTA 308 being plugged into IDE 306. Using the fimctions provided by RTA 308, 
communication with EIS 312 will be initiated by RTA 308 to retrieve a list of the services 
provided by the EIS 312 and a description of those services. In the exemplary embodiment the 
list of services is a simple character string but other formats (e.g., arrays, XML documents, etc.) 
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could equally be employed. A description for each of the services listed is, in the exemplary 
embodiment, provided by RTA 308 to IDE 306 in the form of a single WSDL document 
(although other data formats could equally be employed) describing all of the services. However, 
it is contemplated that a single document (whether in the form of WSDL documents or 
5 documents conforming to a different standard) each describing only a single service could also be 
employed. In this case, IDE 306 would be provided with one or more documents describing the 
services of EIS 312. 

Other methods of providing the list of services provided by EIS 312 and description of 
those services listed may be employed. For example, RTA 308 may include data which lists the 

10 services. This data, which forms part of RTA 308 prior to RTA 308 being plugged into IDE 306, 

may be accessed by the IDE 306. A description of the services listed may then require 
communication with EIS 312. In a variation to this described altemative, the list of services 
provided by EIS 312, which forms part of RTA 308 may be updated by communication with EIS 
312. In a forfher altemative, both the list of services provided by EIS 312 and a description of 

15 those services may form part of RTA 308. hivoking the functions of RTA 308 could then retum 
the list and description to IDE 306. In a variation to the further altemative described above, the 
list of services and description of these same services could be updated by communication with 
EIS 312. 

Also shown in FIG. 4 is business appUcation 310b which is also created through the 
20 facilities of IDE 306. In the case of application 3 1 Ob, access to the services provided by EIS 3 1 2c 
is described to IDE 306 by a RTA 308 associated (or designed to interact) with EIS 312c 
(namely, RTA 308c). The information obtained from RTA 308c is used by IDE 306 to assist in 
the development of application 310b. 

FIG. 5 illustrates an exemplary runtime environment which embodies aspects of the 
25 present invention. As shown, application server 314 hosts RTAs 308a, 308b, 308c, 308i. Each 
RTA 308 facilitates communication between a corresponding EIS 312 and at least one business 
application 310. A single business application 310 may communicate with one or more RTAS 
308. For example, business application 310a is shown communicating with two EISs 312 



CA9-2001-0078 



(namely EIS 312a and 312b) via corresponding RTAs 308a, 308b. Similarly, business 
applications 310b and 310i communicate with EISs 312c and 312i, respectively, through 
operation of RTAs 308c and 308i, respectively. A single adapter 308 could also be used 
simultaneously by more than one business application 310 (although this is not illustrated). 

5 An exemplary RTA 308 is illustrated in greater detail in FIG. 6. As shown, RTA 308 

includes a connector portion 602 combined with RTA tooling portion 604. The tooling portion 
604 includes RTA ftinctions 612 and a format handler generator 610. The WSDL docximent(s) 
608 and extensibility elements 606 are in the exemplary embodiment retrieved or created as a 
result of interaction between RTA 308 and IDE 306. 

10 In the exemplary embodiment connector portion 602 is embodied in a J2EE connector. 

As a cursory overview a J2EE connector includes the following: a connection element and an 
interactive element which includes an Interaction and an InteractionSpec element. The 
Connection element operates to create and manage connections between an appHcation server 
(e.g., application server 314) and a connector 602. The interactive elements (Interaction and 

15 InteractionSpec elements) provide the mechanism to drive an interaction between a RTA and the 
associated EIS 312. The Interaction element enables the execution of specific EIS functions. In 
the J2EE architecture, the Interaction element includes an execute method that takes an input 
record, an output record and an InteractionSpec element. The execute method executes the EIS 
function represented by the InteractionSpec element. The InteractionSpec element holds 

20 properties for driving interaction (using an Interaction element) with an EIS 312. 

The extensibility elements 606 extend the definition of the base elements (port, operation, input 
and output messages) in the WSDL document. That is, the definition of tiiese base elements are 
extended wifli details which are used to map between the fimctionality of the connector 602 (which is, 
in the exemplary embodiment, a J2EE connector) and the sCTvices which are abstractly defined by the 
25 abstract services information document 608. The mapping between the J2EE connector artifacts and the 
elements 606 are indicated in Table I below. 



J2EE Connector Element 


WSDL Elements 


Cormection 


port 
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Interaction 


operation 


InteractionSpec 


operation binding 


Record 


input message 


Record 


output message 



Table I 



It may be desirable in some circumstances to establish fiirther extend the input and/or output 
messages. This would enable a mechanism which defines the translation of the messages into the data 
5 type of the underlying EIS system. In the exemplary embodiment, the input and output messages are 
bound to the Streamable. write and Streamable,read elements of the J2EE connector 602. 

Binding, in WSDL, refers to a process associating a protocol or data format information with an 
abstract entity like a message, operation, or port. 

Exemplary pseudo-code (in Extensible Markup Language - XML) is shown below: 

10 <definitions .... > 

<binding .... > 

<connector:binding ...interaction attributes ... > 
<operation .... > 

<connectonoperationfunclionName="name" ... interaction attributes ... > 
15 <lnput> 

Format bindings may be applied tiere 

</input> 
<output> 

Format bindings may be applied here 

20 </output> 

<fault>* 

Format bindings may be applied here 

</fault> 
</operation> 
25 </binding> 

<port .... > 

<connectoraddress hostName="uri" portNumber="..." ...connection attributes ... /> 
</port> 

30 </definitions> 



As will be appreciated by those of ordinary skill in the art, the namespace, and its identifier, 
should be defined in an earUer section of the WSDL document. 

The connectonbinding structure signifies that tiie binding is bound to a selected connector (in 
35 the exemplary embodiment connector 602 which is embodied by a J2EE connector architecture-based 
connector). The identifier connect r is the short name for the namespace that identifies a particular 
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connector. For example, the code <cics:binding ... /> identifies the connector 602 as being a RTA for a 
Customer Information Control System (CICS) - an EIS 312. The connect rbinding structure may 
optionally contain InteractionSpec attributes that are valid for the operations bound to a selected port. 

The connectorioperation structure contains the InteractionSpec attributes so that an operation 
5 on the EIS 3 12 can be executed. For example, the following code binds the function GETCUST on the 
EIS 312 (a CICS server): 

<cics:operation fLinctionName="GETCUST" l> 

The connectoraddress structure contains the ManagedConnectionFactory attributes so that an the 
1 0 connection factory (which forms part of the Connection elements described above) can be appropriately 
configured. The following pseudo-code is exemplary of setting the URL and name of a CICS server (an 
EIS 312): 

<cics:address connectionURL=". . serverName=". . /> 



15 The abstract services information document 608 (which in the exemplary embodiment is a 

WSDL document) provides an abstract description of the services provided by an associated EIS 312. 
Hereinafter the abstract services information document 608 will be referred to as the WSDL documait 
608 for ease of reference. 

RTA functions 612 (hereinafter functions 612) are desaibed in a WSDL document (althou^ 
20 other languages could equally be employed). Functions 612 are two functions or methods which can be 
invoked: FindService and GeUbstractServicelnforrmtionDocuments (which in the exemplary 
embodiment is renamed GetWSDLDocuments). 

The first function, FindService (which persons of ordinary skill in the art is simply an 
exemplary function name), is used by an IDE 306 to query the names of all the fiinctions (or services or 
25 operations - collectively "sendees") offered by a particular EIS 3 1 2. The FindService fiinction is used so 
that client code can be created which can access the services identified by the calling of the FindService 
function. As such, the FindService fimction is used by an IDE 306 as a mechanism to identify the set of 
possible services for which code can be created. The FindService fiinction, when invoked by an IDE 
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306 causes RTA 308, in the exemplary embodiment, to establish communication with its associated 
EIS 312. Once communication has been established, RTA 308 will query EIS 312 to detemiine the 
services provided by the EIS 312. Once determined, RTA 308 wall return a list of the services to K)E 
306. The Ust of services is provided to IDE 306, in the exemplary embodiment, in the form of a 
5 character string. However, other data formats (e.g., arrays, XML docummts, etc.) could alternatively be 
employed. 

The second fimction, GetWSDLDocuments in the exemplary embodiment, is used by an IDE 
306 to retrieve the descriptions for the particular functions identified using the FindSendce fimction. 
These descriptions provide the necessary information (including the connector bindings) such that an 

10 IDE 306 can generate the necessary code (forming part of a business ^Ucation 310) to interact with 
the service provided by an EIS. In the exemplary embodiment, a single WSDL document is returned to 
IDE 306 which describes every service listed in the data returned by the call to FindService. The single 
WSDL document retumed by GetWSDLDociments forms the WSDL document 608 (FIG. 6). As will 
be appreciated, other data formats (e.g., using a different description language, returning one document 

1 5 for each service retumed by FindSendce) could be raiployed in alternative embodimmts. 

It should be noted that while these two fiinctions {FindService and GetWSDLDocuments) are 
described in the exemplary anbodiments as being implemented internally as part of a RTA 308, these 
two fimctions could, in an altemative embodiment, be implmiented by an EIS 312, or implemented in 
some other repository. However, providing flie fimctions 612 as part of a RTA 308 ensures that an IDE 
20 306 has a simple mechanism to identify where, and how, to access the services provided by an EIS 3 12 
since the fimctions and the information the fimctions access (stored as part of the WSDL docimient 
608) and extension elements 606 are, ultimately, packaged as part of a RTA 308. 

Format handler generator 610 provides a mechanism that can be used by IDE 306 to generate 
code for handling the different data formats employed by the EIS 312 and ttie business appUcation 310 
25 which is designed to use the services of the EIS 3 1 2. That is, the data types of the business application 

310 and the data types of the EIS 312 may differ. Accordingly, an IDE 306 tasked with creating 
business application 310 must also gmerate a format handler as part of business application 310 to 
essentially convert between the data types of the business q^pUcation and ttie EIS. As sudi, m the 
exemplary embodiment, RTA 308 provides format handler generator 610 which is used by IDE 306 to 
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generate the code to perform this conversion service. As will be ^predated, format handler generator 
610 need not form part of RTA 308 but could, in alternative embodiments, be provided by another 
repository (i.e., be separated from RTA 308). 

To invoke a service on EIS 312 using a RTA 308 the exemplary embodiment requires certain 
5 data (or metadata): the connection properties so that the connector 602 (using the 

ManagedConnectionFactory interface) can be used to create a physical connection to the EIS 312 
associated with the RTA 308; the interaction properties to be used with the Interaction Spec element of 
the connector 602; the record to be used and its structure to communicate witti an EIS 312; and the 
operation offered by the EIS 3 1 2. 

10 As noted above by Table I, there is a binding, association or mapping between services 

associated with the EIS 312 and the corresponding portions of the connector 602 (which, in the 
exemplary embodiment, is a J2EE connector). 

The exemplary binding between input and output messages and the Streamable. write and 
Streamable.read, respectively, provides the link between messages sent to an EIS 312 and messages 

15 returned by the EIS 312. As will be appreciated by those of ordinary skill in the art, the structure of the 
messages and their associate format must be ensured so that an EIS 3 12 can interpret messages received 
from a RTA 308. Similarly, messages from an EIS 312 to a business application 310 need to be 
formatted and structured in a manner which can be interpreted by the business application. This 
conversion between formats is handled by a format handler generated using the functionality provided 

20 by format handler generator 6 1 0. 

The operations of IDE 306, RTAs 308 (and the components thereof), a business application 
310, an EIS 312 may be better undCTStood with reference to the operations illustrated in FIG. 7. 
Operations 700 are performed during the creation of a business application 310 designed to interact 
with an EIS 312. The creation of business application 310 will be created through the operation and 
25 interaction between IDE 306 and a RTA 308. The areated business appUcation 310 will, during 
runtime, use the same RTA 308 (and, more particularly, the connector portion 602) to use the services 
ofanEIS312. 

Initially, IDE 306 receives data indicating that the business ^pUcation 310 being developed by 
a usCT requires interaction with various services provided by a selected EIS 312 (S702). The data 
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received may be provided through mouse clicks or other means of data aitry. Responsive to the 
received request, DDE 306 attempts to locate whether a RTA for the selected EIS 312 is available 
(S704). Such a determination may be made by accessing a lookup table or querying a repository which 
identifies those RTAS 308 which have been "plugged" into the IDE 306. If the required RTA 308 
5 (determined by flie search performed in S704 based on ttie identity of the selected EIS 312) is not 
available (S706), IDE 306 is unable to goioate the code required (S708). Li such an instance, the user 
of IDE 306 may be provided a warning message and, in some embodiments, prompted to provide a 
RTA308 (or the location of such) which is adapted to interact with the selected EIS 312. 

If, however, IDE 306 locates in S704/S706 that the required RTA 308 is available, a query is 
1 0 transmitted to the RTA 308 requesting identification of the services which are provided by the EIS 3 1 2 
with which the RTA is associated (S710). Responsive to this request to RTA 308, RTA calls the 
FindService function (which forms part of functions 612 - FIG. 6). IDE 306 uses the WSDL document 
to invoke the FindService function of RTA 308. The WSDL document provides the information 
necessary to IDE 306 to invoke this function. In the exemplary embodiment each RTA 308 implements 
15 the FindService function internally. However, the FindService function, in alternative embodiments, 
could be delegated to the associated EIS 312 or some other repository. (As noted above, altemative 
embodiments may update or generate WSDL document 608 responsive to a request for identification of 
services received fix)m IDE 306. These altemative embodiments may involve RTA 308 communicating 
with EIS 312 to update WSDL document 608.) 

20 If RTA 308, responsive to a request received (S710) returns a null list of service or Ms to 

respond (S712), IDE 306 will be unable to assist in generating code for ^pUcation 310 (S714). 
However, if a list of services provided by EIS 312 is successfully returned by RTA 308 (as a result of 
communication witii EIS 312) to IDE 306, IDE 306 is able to presmt to a user the identities of these 
services (S716). The services may be presented using the GUI of IDE 306 in a manner known to those 

25 of ordinary skill in the art (e.g., in a pane, separate window, as a drop down list, etc.) . 

Responsive to the services presented to a user (or at some later point in time), IDE 306 may 
receive data indicative of a user's selection of (i.e., desire to use) one or more of the services offered by 
the EIS 312 and presented to the user in S716 (S718). The received user selection data may be in any 
known form (e.g., mouse clicks, data entry, or the like). 
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On receipt of the user selection data (S718), IDE 306 will invoke the GetWSDLDocuments 
function (a portion of functions 612) of the RTA 308 (S722). If the invocation of the 
GetWSDLDocuments is unsuccessful (e.g., no WSDL documents 608 are returned, IDE 306 receives 
no response, etc.) (S722), IDE 306 will be unable to assist a user in generating code for a business 
^plication 310 which utilizes the functions selected in S718 (S724). If there is such a failure, IDE 306 
may inform a user through the display of an error message, warning or the like. 

However, if a WSDL docummt(s) 608 is retumed (as a result of communication between RTA 
308 and EIS 312), IDE 306 will (having me^ed the connector 602 elements to the extensibility 
elements 606) thm be able to generate code for business application 310 which accesses tiie services 
provided by EIS 312. 

As will be appreciated by those of ordinary skill in the art, IDE 306 may have, serially or 
simultaneously, more than one RTA 308 "plugged in" during tiie oreation of a business ^plication 310. 

Operations 800 (FIG. 8), shown in flow chart form, illustrate the operations performed during 
the runtime of a business application 310 developed using IDE 306 and a RTA 308. During execution 
(or during initialization) business application 310 will establish communication with RTA 308 (which 
is hosted application server 314 -FIG. 4) (S802). During operation S802 (and the remainder of 
operations 800) bxisiness application 310 will only communicate with RTA 308 using the facilities 
provided by the cormector portion 602 (i.e., the functionality provided by RTA enhancements 604 are 
not employed during operations 800). After communication between RTA 308 and business application 
310 has been established (S802), requests for services from EIS 312 made by business application 310 
will be brokered by the operation of RTA 308 (S804). When the services of EIS 312 are no longer 
required by business appUcation 310, communication with RTA 308 may be terminated (S806). Such a 
termination may occur, for example, during the continued execution of business application 310 or 
during a process to terminate execution of business application 310. 

As will be appreciated by those of ordinary skill in the art, any business application (regardless 
of whether created through use of IDE 306 or a conventional IDE (i.e., an IDE tiiat does not leverage 
the inventive aspects of RTA 308 but rather uses a conventional adapter tool to create code to access an 
EIS)) could also be used in place of business application 3 10. Similarly, a business application designed 
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to employ a RTA, could use either a RTA 308 (embodying aspects of the present invention) or a 
connector 602 only. 

As will be appreciated by those skilled in the art, modifications to the above-described 
embodiment can be made without departing fi-om the essence of the invention. For example, the 
5 enhancements portion 604 (FIG. 6) of RTA 308 could be separated fi-om the connector portion 
602. In this embodiment, only portion 604 need be "plugged" into IDE 306 during development. 
However, unlike the adapter-tool sets described above, the enhancements portion 604 would be 
responsible for communicating with its corresponding connector 602 that may be deployed on 
some other system. In a further alternative, the two RTA functions described above, 
10 FindService and GetWSDLDocumenis, could be combined into a single fimction. Alternatively, 
the two fimctions could be called simultaneously or serially (i.e., without other intervening 
actions). 

While one (or more) embodiment(s) of this invention has been illustrated in the 
accompanying drawings and described above, it will be evident to those skilled in the art that 
15 changes and modifications may be made therein without departing from the essence of this 
invention. All such modifications or variations are believed to be within the sphere and scope of 
the invention as defined by the claims appended hereto. Other modifications will be apparent to 
those skilled in the art and, therefore, the invention is defined in the claims. 
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What is claimed is: 

1 . A resource adapter comprising: 

a first mechanism providing a description of a service provided by an enterprise 
information system sufficient to invoke said service; 

a second mechanism for invoking said service described; 

said resource adapter adapted to communicate with an integrated development 
environment to assist in development of a business application; and 

said resource adapter further adapted to communicate with a business appUcation during 
execution of said business application. 

2. The resource adapter of claim 1 wherein said first mechanism, responsive a request for a 
description of a service provided by an enterprise system, provides said requested description 
having queried said enterprise information system. 

3. The resource adapter of claim 1 wherein said first mechanism providing a description of a 
service comprises a document describing said service. 

4. The resource adapter of claim 3 wherein said document comprises an XML document. 

5. The resource adapter of claim 4 wherein said XML document conforms to the WSDL 
standard. 

6. The resowce adapter of claim 1 wherein said resource adapter is adapted to conMnunicate 
with a business application during execution of said business application via a connector, 
said connector comprising one of: a Java 2, Enterprise Edition (J2EE) Connector 
Architecture connector; and a Common Connector Framework (CCF) connector. 

7. The resource adapter of claim 6 wherein said second mechanism maps elements comprising 
said description of said service to elements of said connector. 
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8. The resource adapter of claim 7 wherein said connector comprises a J2EE connector and said 
second mechanism maps from said description of said service to connection and interaction 
elements of said J2EE connector. 

9. A method for generating code for a business application, said code adapted to use a connector 
to access a service provided by an Enterprise Information System (EIS), said method 
comprising: 

receiving data describing said service provided by said EIS; 

mapping said data describing said service to elements of said connector; 

generating code of said business application, said code implementing said mapping. 

10. The method of claim 9 wherein said receiving data describing said service comprises: 

querying a resource and tooling adapter for data describing said service; and 
responsive to said querying, receiving said data. 

11. The method of claim 10 wherein said code generated is adapted to said resource and tooling 
adapter. 

12. The method of claim 10 wherein said resource and tooling adapter comprises a connector and 
a document describing said service provided by said EIS. 

13. The method of claim 12 wherein said connector is one of: a Java 2, Enterprise Edition (J2EE) 
Connector architecture connector; and a Common Connector Framework (CCF) connector. 
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14. An integrated development environment (IDE) for generating a business application, said 
business application, when executed, uses services provided by an enterprise information 
system (EIS), said IDE comprising: 

an interface for querying a resource and tooling adapter to ascertain a service provided by 
said EIS; 

said interface for receiving a response to a query from a resource and tooling adapter, said 
response describing said service provided by said EIS and information to invoke said 
service; and 

a generator generating code for said business application to access said service, said code 
using data from said response. 

15. A computer readable media storing data and instructions readable by a computer system, said 
computer system executing an integrated development environment (IDE) for generating a 
business application to access a service provided by an Enterprise Information System (EIS), 
said data and instructions defining a resource and tooling adapter that, when deployed on said 
computer system, adapts said IDE to: 

obtain a description of said service, said description providing details required to invoke 
said service; and 

using said description of said service, generate code which when executed, commxmicates 
with said resource and tooling adapter to use said service. 
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16. A resource adapter comprising: 

first means for commimicating with an integrated development environment (IDE) during 
development of a business application; 

second means for conmiunicating with an Enterprise Information System (EIS); 

third means for conmiunication with an executing business application; 

fourth means for providing a description of a service provided by said EIS to said IDE; 

and 

fifth means for mapping aspects of said description of said service to said third means. 

17. The resource adapter of claim 16 wherein said second and third means comprise a connector. 

18. The resource adapter of claim 17 wherein said connector comprises one of: a connector 
conforming to the Java 2, Enterprise Edition (J2EE) Connector Architecture; and a connector 
conforming to the Conmion Connector Framework architecture. 

19. The resource adapter of claim 17 wherein said fourth means comprises an abstract description 
of said service. 

20. The resource adapter of claim 19 wherein said abstract description of said service comprises 
one or more documents conforming to the Web Services Definition Language (WSDL). 

21. The resource adapter of claim 20 wherein said connector comprises said connector 
conforming to the J2EE Connector Architecture and said fifth means comprises mapping said 
extensibility elements to connection and interaction elements of said J2EE connector. 

22. The resource adapter of claim 17 wherein said fifth means comprises mapping elements in 
said abstract description of said service to connection and interaction elements of said 
connector. 
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23. A method of adapting an integrated development environment to enable generation of code to 
use a service provided by a back end system, said method comprising: 

transmitting to said integrated development environment data describing said service; and 

mapping elements of said data describing said service to elements of a connector, said 
connector for facilitating communication between said back end system and an 
application generated to use said service provided by said back end system. 

24. The method of claim 23 further comprising: 

prior to transmitting, initializing communication with a resource and tooling adapter. 

25. The method of claim 24 wherein said transmitting comprises: 

receiving listing data listing said service. 

26. The method of claim 25 wherein said transmitting further comprises: 

receiving data describing said service listed by said listing data. 

27. The method of claim 23 further comprising: 

prior to said transmitting, said resource and tooling adapter, responsive to a query of said 
back end system, receiving said data describing said service. 

28. A resource adapter comprising: 

a connector adapted to facilitate, during execution of an application, communication 
between said application and a back end system resulting in said application xising a 
service provided by said back end system; 

functions to provide an integrated development environment (IDE) with a description of 
said service wherein said elements of said description map to elements of said connector. 
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29. The resource adapter of claim 28 wherein said functions are adapted to query said back end 
system for said description. 

30. The resource adapter of claim 28 wherein said connector comprises one of a Java 2, 
Enterprise Edition (J2EE) Connector Architecture connector and a Common Connector 

5 Framework (CCF) connector. 

31. The resource adapter of claim 28 wherein said description comprises a service listing 
identifying said service. 

32. The resource adapter of claim 31 wherein said description further comprises one or more 
documents describing services identified by said service listing. 

10 33. The resource adapter of claim 32 wherein said one or more docxmients conform to the WSDL 
standard. 

34. The resource adapter of claim 28 wherein said resource adapter is adapted to communicate 
with said DDE during development of said application and further adapted to communicate 
with said application and said back end system during execution of said application. 

15 35. The resource adapter of claim 34 wherein said resource adapter is further adapted to 
communicate with said back end system during development of said application. 
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S702 

IDE USER WISHES TO DEVELOP A CLIENT APPLICATION THAT 
INTERACTS WITH EIS 



S704 

IDE LOOKS UP THE RESOURCE ADAPTER FOR EIS SYSTEM C FROM 
THE SET OF RESOURCE ADAPTERS THAT ARE INSTALLED IN IT 
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S708 

IDE FAILS TO GENERATE 
CLIENT CODE 
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IDE GETS THE WSDL SERVICE DOCUMENT FOR THE RESOURCE 
ADAPTER AND CALLS "FIND SERVICE" ON THE EIS 
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IDE FAILS TO GENERATE 

CLIENT CODE 
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IDE DISPLAYS THE RETURNED LIST TO THE USER 
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IDE RECIEVES USER SELECTION DATA IDENTIFYING 
FUNCTIONS/SERVICES PROVIDED BY EIS FOR WHICH CODE NEEDS 
TO BE GENERATED 
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IDE CALLS THE "GetWSDLDocuments" SERVICE PASSING THE USER 
SELECTION DATA 
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IDE FAILS TO GENERATE 
CLIENT CODE 
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IDE GENERATES CLIENT CODE. FOR ACCESSING 
FUNCTIONS A AND B FROM THE RETURNED WSDL 
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S802 

BUSINESS APPLICATION 310 INITIALIZES COMMUNICATION WITH 
RESOURCE ADAPTER 308 



I 



S804 

BUSINESS APPLICATION 310 USES SERVICES OF EIS 312, 
COMMUNICATION BETWEEN EIS 312 AND BUSINESS APPLICATION 
310 BROKERED BY RESOURCE ADAPTER 308 



S806 

BUSINESS APPLICATION 310 TERMINATES COMMUNICATION WITH 
RESOURCE ADAPTER 308 



